home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / hscats13.zip / HSCATS.DOC < prev    next >
Text File  |  1992-02-09  |  9KB  |  198 lines
  1.                                  H S C A T S
  2.                                  Version 1.3
  3.  
  4.  
  5.                  WILDCAT 3.xx AND HSLINK INTERFACE HELP DOC'S
  6.                  --------------------------------------------
  7.  
  8.    Here it is!  Wildcat and HsLink, together.
  9.    The saga continues..........
  10.  
  11.    If you have used HsLink, you know it is a powerful file transfer
  12.    protocol that allows you to upload and download at the same time,
  13.    essentially doubling your throughput.  HsCats will interface HsLink
  14.    to Wildcat so your users can enjoy this terrific protocol on your
  15.    Wildcat system.
  16.  
  17.    Setting things up is simple, and we'll go through it step by step.
  18.                                                                        
  19.  
  20.               USE A WORK DIRECTORY FOR YOUR UNARCHIVING OF FILES
  21.  
  22.    Create a new directory to work in.  This keeps things much easier to
  23.    follow along with and clean up after.
  24.  
  25.    Ok, here we go.
  26.  
  27.    1.  Take all the .COM files from the HsLink archive (HSLxxx.ZIP)
  28.    and put them in any directory that you have your dos environment
  29.    'path' set up for.  Type 'set' at the dos prompt to check.  I set
  30.    everything into a directory called c:\wc\ep and include it in the
  31.    path statement in my autoexec.bat.
  32.  
  33.    2.  Do the same thing with THE *.EXE files from this (HSCATSxxx.ZIP)
  34.    archive.  All the files should now be available in the path.
  35.  
  36.    3.  Place the copy of HSLINK.CFG I have included into each of your
  37.    node home directories. IE: c:\wc30\wcwork\node1, c:\wc30\wcwork\node2,
  38.    etc.
  39.  
  40.    4.  In each directory that you put a copy of HSLINK.CFG, run
  41.    HSCONFIG to make changes necessary for your system.  The copy I have
  42.    included is a regular setup and should not require much modification.
  43.    Make changes to this section as follows. Remember to run HSCONFIG from
  44.    the node directory! You should refer to the HsLink Docs for further
  45.    information regarding HsLink's options.
  46.  
  47.        A. 'Directory for downloaded files' should be set to your node's
  48.    ep directory.  HSCATS will do all that work for you for each caller
  49.    engaged in a HsLink session. We only need to fill it in the first
  50.    time.
  51.  
  52.    5.  Complete steps 4.A through 4.K for each one of your nodes if you
  53.    are multi-node Wildcat.
  54.  
  55.    7.  Copy the enclosed HSLDN.BAT and HSLUP.BAT batch files to your
  56.    home directory. Then change to the home directory. Edit whatever you
  57.    need to on the batch files I have included.
  58.  
  59.    8.  Run Makewild (still in the home directory) and go to the External
  60.    Protocol section. Add HsLink to the external protocol menu as such:
  61.  
  62.    [H]  HsLink  HSLUP.BAT  HSLDN.BAT   Y
  63.  
  64.    * Make sure you set the Wildcat Node Id and Port Id in the batch
  65.    file that calls Wildcat for each node used. This should be in your
  66.    Cat.Bat file that calls the node for operation. Two more enviroment
  67.    variables should be set in you cat.bat file they are homepath and
  68.    nodepath, see below:
  69.  
  70.    IE: Set WCNODEID=(node you are on ie: 1)
  71.        Set WCPORTID=(port you are using on that node ie: 1)
  72.        Set HOMEPATH=(path to home directory ie: C:\WC30\)
  73.        Set NODEPATH=(path to node directory ie: C:\WC30\WCWORK\NODE1\)
  74.    
  75.    * Remember to add the extra backslash at end of directories above.
  76.    
  77.    * HsCats offers file virus scanning via ScanFile.Bat If HsCats
  78.    finds the file "SCANFILE.BAT" it will shell to EMS or DISK before
  79.    adding the file to Wildcat's database. ScanFile.Bat will do it's normal
  80.    job of scanning the file. If the file fails, HsCats will add it to
  81.    the database with the failed scan flag set to Y. It will also subtract
  82.    the file and upload kilobytes from the users record. PLEASE SEE THE
  83.    HSCATS.HIS FILE FOR MORE INFO CONCERNING SCANFILE.BAT.
  84.  
  85.  
  86.                                ┌──────────────┐
  87.                                │ UPLOAD NOTES │
  88.                                └──────────────┘
  89.  
  90.    Through the use of PREHSCDN.EXE, a single selectable upload area is
  91. supported, so the user may upload to an area of their choice that they
  92. have access to normally.  All uploads that occur during any one
  93. session will go to the area that the user so chooses, they will only
  94. be allowed to choose areas for which they have security for. This
  95. means for each HSLINK session they can select the area they want to
  96. upload too.
  97.  
  98.    Save Upload's to Which Area ("?" for Choices) ?
  99.  
  100.    [1] New Uploads
  101.    [26] Sysop Only!
  102.  
  103.    They will only be shown areas for which they have security for in WC!
  104.   
  105.    * At present the user must still select the area manually, even if they
  106.    are allowed only one area to upload to.
  107.  
  108.  
  109.    So there you have it in a nut shell. It is easy to setup and totally
  110.    worth the effort!!!! If you should have any questions please feel
  111.    free to call me and I will help you out. I can be reached at my BBS
  112.    from 6pm till 6:00am (East Coast Time), Which at present is the only
  113.    hours my bbs will be up and running. PLEASE do not call anytime other
  114.    than the hours specified until I get another phone line installed.
  115.    The BBS # is (717)-731-8299 (19,200 V42/Bis) Good Luck and thanks for
  116.    supporting HSCATS, HSLINK & WILDCAT!
  117.  
  118.  
  119.  
  120.                                               Enjoy!        02/07/92
  121.  
  122.                                 Dale Fedorchik
  123.                              The Cat's Castle BBS
  124.  
  125.  
  126.                                  Warranty
  127.  
  128.  
  129.    This is product is provided "as is" without warranty of any kind. The
  130.    entire risk as to the results and performance of the program is
  131.    assumed by you. Futher more, I the author do not warrant, guarantee,
  132.    or make any representations regarding the use of, or the results of
  133.    the use of the program, and you rely on the program and results
  134.    solely at your own risk. I the author cannot accept responsibility
  135.    for system damage, loss of profit, or any other special, incidental,
  136.    or consequential damages resulting from the use or inability to use
  137.    this product.
  138.  
  139.  
  140.    Ok..folks, here is the scoop...I created HsCats to allow HsLink and
  141.    Wildcat to co-exist together.
  142.  
  143.    HsCats has four parts PREHSCUP, AFTHSCUP, PREHSCDN, and AFTHSCDN.
  144.    These are called from the batch protocol file either HSLUP.BAT or
  145.    HSLDN.BAT. Here how it works...pay close attention!
  146.  
  147.  
  148.    USER DOWNLOAD SESSION:
  149.  
  150.    They user marks off what files they wish to download via Wildcat's file
  151.    marking system. Just as they would with any other protocol. They then
  152.    select to download and are offered the protocol menu screen. They select
  153.    [H] for HsLink and away we go.....
  154.  
  155.    The HSCDN.BAT batch file first calls PREHSCDN.EXE which prompts the
  156.    user for an area to upload to (that they have security for) and writes
  157.    two files...HSCAT.### (Area chosen by user) and HSACESS.### (which is
  158.    the pointer file for areas that they have security to download from).
  159.    It will write this info to the HsLink.Cfg file that you point to on
  160.    the command line.
  161.  
  162.  
  163.    AFTHSCDN.EXE will then be called in the batch file and read the
  164.    STATUS.LOG and HSCAT.### files and add whatever files where uploaded
  165.    during the download session to the Wildcat database. It then updates the
  166.    user record for files uploaded and extra time allotted. Wildcat will take
  167.    care of updating the user and file database for files that where downloaded.
  168.  
  169.  
  170.    USER UPLOAD SESSION:
  171.  
  172.    The user selects the area to upload to via Wildcat as normal. Then WC
  173.    will ask for filenames, descriptions, passwords, keywords, and additional
  174.    info as it does for any protocol used. The user then selects [H] HsLink
  175.    from the protocol menu as transfer type to use.
  176.  
  177.    The HSLUP.BAT batch file first calls PREHSCUP.BAT which sets up the
  178.    HsLink.Cfg file for the proper path to the node's ep directory.
  179.  
  180.    HsLink will then run and send whatever files the user has configured
  181.    in the upload transfer to the node's ep directory. It will
  182.    also allow them to download any files they have configured that they
  183.    have security access for. HsLink will create it's STATUS.LOG after
  184.    the transfer is done.
  185.  
  186.    AFTHSCUP.EXE will then look to see if any downloads occured during the
  187.    session and update the user and file database with the information.
  188.    Wildcat will then check the uploads as it does normally and transfer them
  189.    to the directory chosen by the user at the onset of the session.
  190.  
  191.    In a nut shell...it's kinda like merging HsCats and Wildcat together into
  192.     one package...simply called HsCats.
  193.  
  194.  
  195.                                        Dale Fedorchik, Author
  196.                                        February 9, 1992
  197.  
  198.